Inside Macintosh: QuickDraw GX Objects /

Chapter 7 - View-Related Objects / View-Related Objects Reference

View Device Functions / Manipulating View Device Object Properties

GXSetViewDeviceBitmap

You can use the GXSetViewDeviceBitmap function to set the bitmap property of a view device object.

void GXSetViewDeviceBitmap(gxViewDevice target, 
                           gxShape bitmapShape);

target

A reference to the view device whose bitmap you wish to set.

bitmapShape

A reference to a bitmap shape object that specifies the new bitmap.

DESCRIPTION

The GXSetViewDeviceBitmap function sets the bitmap property in the view device to contain the information in the shape specified in the bitmapShape parameter. Only the bitmap structure in the geometry of the bitmap shape is copied into the view device.

SPECIAL CONSIDERATIONS

The bitmap shape you supply to this function cannot have a disk-based pixel image.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
invalid_viewDevice_reference
parameter_is_nil	(debugging version)
illegal_type_for_shape	(debugging version)
viewDevice_access_restricted	(debugging version)

SEE ALSO

For an example of the use of this function, see page 7-55.

To retrieve the bitmap property of a view device, use the GXGetViewDeviceBitmap function, described in the previous section.

For information about bitmap shapes, see the bitmap shapes chapter of Inside Macintosh: QuickDraw GX Graphics.